W06-1. Kubernetes 입문 - 강의 노트

6주차 강의 노트: Kubernetes 입문 (구조 · 클러스터 · Pod)

이번 주 목표

  1. Kubernetes 가 무엇을 해 주는지, 왜 "선언형" 인지 설명할 수 있다.
  2. 클러스터 구조(Control Plane 과 Worker Node, 주요 구성 요소)를 그림으로 설명할 수 있다.
  3. Kubernetes 의 가장 작은 실행 단위 Pod 를 이해하고, YAML 로 직접 띄울 수 있다.
  4. kubectl 기본 명령(get, describe, logs, exec, port-forward, apply, delete)을 쓸 수 있다.

진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)

지난주 복습

  • Compose: compose.yaml 에 원하는 상태를 선언 → docker compose up -d
  • 한계: 서버 한 대 안에서만, 같은 서비스를 여러 개 띄우면 포트 충돌


1. Kubernetes 가 해 주는 일

Kubernetes(쿠버네티스, 줄여서 K8s)는 여러 대의 서버를 하나의 거대한 컴퓨터처럼 묶어서 컨테이너를 운영해 주는 시스템입니다. 이런 일을 컨테이너 오케스트레이션이라고 부릅니다.

운영 고민 Docker / Compose 만 쓸 때 Kubernetes
어느 서버에 띄우지? 사람이 서버를 골라서 접속 후 실행 알아서 빈 서버를 골라 배치 (스케줄링)
컨테이너가 죽으면? 같은 서버 안에서만 재시작(--restart) 다른 서버에서라도 다시 띄움 (자가 치유)
사용자가 늘면? 사람이 서버에 들어가 하나씩 추가 숫자만 바꾸면 늘어남, 자동으로도 가능 (스케일링)
여러 개 앞의 주소는? 직접 로드밸런서 구성 Service 가 하나의 주소로 나눠 줌
새 버전 배포는? 끄고 → 새로 켜기 (서비스 중단) 하나씩 바꿔 끼우는 무중단 배포
이름의 유래

그리스어로 "배의 조타수" 라는 뜻입니다. 로고가 배의 키(타륜) 모양입니다. K 와 s 사이에 글자가 8개라서 K8s 라고 줄여 씁니다.
Google 이 내부에서 쓰던 시스템(Borg)의 경험을 바탕으로 2014년에 공개했고, 지금은 CNCF(Cloud Native Computing Foundation)가 관리하는 사실상의 표준입니다.


2. 핵심 사상: 선언형 + 조정 루프

flowchart LR
    U["나: 원하는 상태를 선언
'방명록 Pod 3개'"] --> A["Kubernetes
(저장)"] A --> L{"현재 상태 =
원하는 상태?"} L -- "아니오: 2개뿐" --> F["차이를 없애는 조치
(1개 더 띄움)"] F --> L L -- "예" --> W["계속 지켜봄"] W --> L
에어컨 비유

에어컨에 "24도" 를 설정해 두면, 에어컨이 실내 온도를 계속 재면서 차이가 생길 때마다 알아서 냉방을 켜고 끕니다.
Kubernetes 도 똑같습니다. 우리는 "방명록 3개" 처럼 원하는 상태만 적어 두고, Kubernetes 가 현재 상태를 계속 확인하며 차이를 메웁니다. 이것을 조정 루프(Reconciliation Loop) 라고 합니다.
그래서 Pod 하나가 죽으면 사람이 손대지 않아도 다시 3개가 됩니다(7주차에 직접 확인).


3. 클러스터 구조

Kubernetes 를 이루는 서버 묶음을 클러스터, 클러스터를 이루는 서버 한 대 한 대를 노드(Node) 라고 부릅니다.

flowchart TB
    K["kubectl
(내 노트북)"] -- "명령 (API 요청)" --> API subgraph CP["Control Plane (관리 본부)"] API["kube-apiserver
모든 요청의 창구"] ETCD[("etcd
클러스터 상태 저장소")] SCH["kube-scheduler
Pod 를 어느 노드에?"] CM["kube-controller-manager
조정 루프들"] API --- ETCD SCH --- API CM --- API end subgraph N1["Worker Node 1"] KL1["kubelet"] --> CR1["containerd"] --> P1["Pod"] KP1["kube-proxy"] end subgraph N2["Worker Node 2"] KL2["kubelet"] --> CR2["containerd"] --> P2["Pod"] KP2["kube-proxy"] end API --- KL1 API --- KL2

선(---)은 서로 주고받는다는 뜻입니다. 모든 구성 요소는 apiserver 와 양방향으로 통신합니다.

3-1. Control Plane: 관리 본부

구성 요소 하는 일 비유
kube-apiserver 모든 요청을 받는 유일한 창구. kubectl 도, 다른 구성 요소도 모두 여기를 거침 본사 민원 창구
etcd 클러스터의 모든 상태(원하는 상태 + 현재 상태) 를 저장하는 데이터베이스 본사 장부
kube-scheduler 새 Pod 를 어느 노드에 둘지 결정 (자원 여유 등을 보고) 배차 담당
kube-controller-manager 원하는 상태와 현재 상태를 비교하며 차이를 메우는 조정 루프들의 모음 현장 감독 (에어컨의 온도 조절기)

3-2. Worker Node: 실제로 컨테이너가 도는 서버

구성 요소 하는 일 비유
kubelet 자기 노드에 배정된 Pod 를 실제로 띄우고 상태를 보고 각 현장의 현장 소장
containerd (컨테이너 런타임) 컨테이너를 실제로 실행 (1주차의 containerd + runc 그대로!) 작업자
kube-proxy Service 로 들어온 트래픽을 Pod 로 전달하는 네트워크 규칙 관리 (8주차) 교통 정리
Docker 를 먼저 배운 이유

노드에서 컨테이너를 실행하는 것은 1주차에 본 containerd + runc 입니다. 그래서 4주차에 Docker 로 만든 이미지를 Kubernetes 가 그대로 실행할 수 있습니다.

3-3. 명령 하나가 처리되는 흐름

kubectl apply -f pod.yaml 을 실행하면:

sequenceDiagram
    participant U as kubectl
    participant A as kube-apiserver
    participant E as etcd
    participant S as kube-scheduler
    participant K as kubelet (노드)
    U->>A: Pod 를 만들어 주세요 (YAML)
    A->>E: "원하는 상태" 저장
    S->>A: 배정 안 된 Pod 발견 → 노드 2 로 배정
    A->>E: 배정 결과 저장
    K->>A: 내 노드에 배정된 Pod 확인
    K->>K: containerd 로 컨테이너 실행
    K->>A: "Running" 보고 → etcd 에 현재 상태 저장

구성 요소끼리 직접 명령하지 않고, 모두 apiserver 를 통해 상태를 읽고 씁니다. 그래서 하나가 잠시 멈춰도 다시 살아나면 상태를 보고 하던 일을 이어 갑니다.


4. 실습 환경: Docker Desktop 의 Kubernetes

방식 특징
Docker Desktop 내장 (kind 방식) ← 우리가 쓸 것 클릭 몇 번으로 생성, 노드 여러 개, 버전 선택 가능, 4주차 이미지를 바로 사용
minikube, kind(단독), k3d 노트북용 클러스터 도구. 원리는 같음
관리형 K8s (EKS, AKS, GKE, NHN NKS, Ncloud NKS 등) 클라우드가 Control Plane 을 대신 운영 (10주차)
kind = Kubernetes in Docker

노드 하나하나가 컨테이너로 만들어집니다. 그래서 노트북 한 대로도 "서버 3대짜리 클러스터" 를 흉내 낼 수 있습니다. 실습에서 docker ps 로 노드 컨테이너를 직접 봅니다.

kubectl 은 따로 설치하지 않아도 됩니다

Docker Desktop 이 Kubernetes 클러스터를 만들 때 kubectl 명령 도구도 함께 설치합니다.


5. Kubernetes 오브젝트와 YAML

Kubernetes 에서 관리하는 모든 것(Pod, Service, Deployment …)을 오브젝트(리소스) 라고 합니다. 모든 오브젝트는 같은 뼈대의 YAML 로 표현합니다.

apiVersion: v1             # ① 이 종류를 정의한 API 버전
kind: Pod                  # ② 오브젝트 종류
metadata:                  # ③ 이름표: 이름, 라벨 등
  name: guestbook
  labels:
    app: guestbook
spec:                      # ④ 원하는 상태 (내가 쓰는 부분)
  containers:
    - name: web
      image: 내아이디/guestbook:v1
      ports:
        - containerPort: 8000
# status:                  # ⑤ 현재 상태 (Kubernetes 가 채움, 우리는 안 씀)
필드 누가 쓰나 의미
apiVersion, kind 나 무엇을 만들지 (Pod 는 v1, Deployment 는 apps/v1 …)
metadata 나 이름과 라벨(분류용 꼬리표)
spec 나 원하는 상태
status Kubernetes 현재 상태 (kubectl get pod -o yaml 로 볼 수 있음)
필드가 기억 안 나면 kubectl explain

kubectl explain pod.spec.containers 처럼 치면 어떤 필드가 있는지 설명이 나옵니다. 인터넷 검색보다 정확합니다(지금 클러스터 버전 기준).


6. Pod: Kubernetes 의 가장 작은 단위

Kubernetes 는 컨테이너를 직접 다루지 않고 Pod 라는 포장 단위로 다룹니다.

flowchart TB
    subgraph POD["Pod (IP 하나: 10.244.1.5)"]
        C1["컨테이너: web
guestbook:v1"] C2["(필요하면) 보조 컨테이너
로그 수집 등"] V[("공유 볼륨")] C1 --- V C2 --- V end
특징 설명
컨테이너 1개 이상의 묶음 보통은 컨테이너 1개 = Pod 1개. 꼭 붙어 다녀야 하는 보조 컨테이너(사이드카)가 있을 때만 여럿
IP 하나를 공유 Pod 안 컨테이너끼리는 localhost 로 통신
일시적(Ephemeral) Pod 는 죽으면 그걸로 끝. 같은 Pod 가 되살아나는 게 아니라 새 Pod(새 이름, 새 IP) 가 만들어짐
노드 하나에서만 실행 Pod 하나가 여러 노드에 걸쳐 있지 않음
Pod 를 직접 만들면 아무도 다시 살려 주지 않습니다

오늘은 연습을 위해 Pod 를 직접 만들지만, 실무에서는 Pod 를 직접 만들지 않습니다. Deployment(7주차)가 "Pod N개 유지" 를 책임지게 합니다.
오늘 실습에서 Pod 를 지우면 그대로 사라지는 것을 확인합니다.

Pod 의 상태

STATUS 의미
Pending 노드 배정을 기다리거나, 이미지를 받는 중
ContainerCreating 노드에 배정되어 컨테이너를 만드는 중
Running 실행 중
Completed 할 일을 마치고 정상 종료
ErrImagePull / ImagePullBackOff 이미지를 받지 못함 (이름·태그 오타가 가장 흔함)
CrashLoopBackOff 컨테이너가 계속 죽었다 살아났다 반복 (앱 에러)

7. Namespace 와 Label

개념 설명 비유
Namespace 클러스터 안을 논리적으로 나눈 공간. 같은 이름의 오브젝트도 Namespace 가 다르면 공존 가능 회사 안의 부서
Label 오브젝트에 붙이는 키: 값 꼬리표. 골라내기(selector)에 씀 분류 스티커

기본으로 있는 Namespace:

이름 용도
default -n 을 안 주면 여기에 만들어짐
kube-system Kubernetes 자체 구성 요소 (건드리지 않음)
kube-public, kube-node-lease 시스템용
Label 이 중요한 이유 (7~8주차 예고)

Deployment 는 "app: guestbook 라벨이 붙은 Pod 를 3개 유지", Service 는 "app: guestbook 라벨이 붙은 Pod 로 트래픽 전달" 처럼, Kubernetes 의 오브젝트들은 라벨로 서로를 찾습니다.


8. kubectl 기본 명령

kubectl 명령은 kubectl <동사> <종류> [이름] [옵션] 모양입니다.

명령 하는 일 Docker 에서는
kubectl get pods 목록 docker ps
kubectl get pods -o wide 목록 + IP, 노드
kubectl describe pod 이름 상세 정보 + 이벤트(무슨 일이 있었나) docker inspect
kubectl logs 이름 로그 docker logs
kubectl exec -it 이름 -- sh 안에 들어가기 docker exec -it
kubectl port-forward pod/이름 8080:8000 내 노트북 포트 → Pod 포트 연결 (테스트용) -p 와 비슷
kubectl apply -f 파일.yaml 파일 내용대로 만들기 / 바꾸기 (선언형) docker compose up -d
kubectl delete -f 파일.yaml 또는 kubectl delete pod 이름 삭제 docker rm
kubectl run 이름 --image=... Pod 하나를 명령으로 바로 만들기 (명령형, 테스트용) docker run
장애 대응 3종 세트

무언가 안 될 때는 순서대로 봅니다.

  1. kubectl get pods → STATUS 확인
  2. kubectl describe pod 이름 → 맨 아래 Events 확인 (이미지·배정 문제는 여기서 보입니다)
  3. kubectl logs 이름 → 앱 에러 확인

핵심 요약

6주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① K8s          여러 서버를 하나처럼: 배치 · 자가 치유 · 스케일 · 무중단 배포
② 사상         원하는 상태를 선언 → 조정 루프가 현재 상태를 맞춤 (에어컨)
③ 구조         Control Plane: apiserver(창구) · etcd(장부) · scheduler(배차) · controller(감독)
               Worker Node : kubelet(현장 소장) · containerd(작업자) · kube-proxy(교통)
④ YAML         apiVersion · kind · metadata · spec (status 는 K8s 가 채움)
⑤ Pod          가장 작은 단위, 컨테이너 1+개, IP 하나, 죽으면 끝 (새 Pod 가 생길 뿐)
⑥ 분류         Namespace = 부서 / Label = 꼬리표 (오브젝트끼리 라벨로 찾음)
⑦ kubectl      get → describe(Events) → logs : 장애 대응 3종 세트

참고 자료

더 깊이 보고 싶다면 (볼트 내 정리 노트):

공식 문서:


네비게이션

이전 목록 다음
◀ 5주차 실습 목록으로 6주차 실습 ▶